home *** CD-ROM | disk | FTP | other *** search
/ Inside Mac Games Volume 7 #1 / IMG Vol 7-1.iso / Shareware / Close Combat Utilities / CC Cartographer.beta / README.doc < prev   
Text File  |  1997-01-05  |  10KB  |  249 lines
  1. ---------------------------------------------------------------------------
  2.   *    Close Combat Cartographer :  Beta 1
  3.   *    January 3, 1997
  4.   *    Matthew Hills
  5.   *      hills@sensors.stanford.edu
  6.   *
  7.   *    Support Site:  http://www-leland.stanford.edu/~hills/games.html
  8. ---------------------------------------------------------------------------
  9.  
  10. Changes since CCcart dev 1
  11. ==========================
  12.   + fixed bugs
  13.   + added features
  14.   + (check development notes for details)
  15.      
  16. Introduction:
  17. =============
  18.  
  19.   Close Combat Cartographer (hereafter "CCcart") is a map editor for the
  20.   Macintosh version of Close Combat (written by Atomic Games, published by
  21.   Microsoft, 1996).
  22.   
  23.   The current development version only supports a few map tools and is
  24.   not terribly useful, as it does not generate a LOS file (necessary for
  25.   the map to be used by Close Combat)
  26.   
  27.   Necessary disclaimer:  I can probably still get this program to crash.
  28.                          Can you?  If so, you should consider backing up files
  29.                          before editing them.
  30.                          
  31. Instructions:
  32. =============
  33.  
  34.   When you first start, a small toolbar will appear and you will be asked to
  35.   locate the "Terrain Tiles" file.  This is the file that defines the basic
  36.   terrain graphics.  This is usually found in:  "Close Combat/Graphics"
  37.   directory.  (See my web address (at top of page) for instructions on moving
  38.   the Close Combat data files onto your hard disk)
  39.   
  40.   CCcart will save the location of this file and you should not have to enter
  41.   it again.
  42.   
  43.   You can open a map file from the "File" menu.  The default maps have names like
  44.   "map3" and can be found in "Close Combat/Data/Maps."  (it isn't a bad idea to
  45.   back them up before editing... but they are on the CD regardless...)
  46.   
  47.   The tool palette currently has the following tools:
  48.     ============================================================================
  49.     =  Tool        Hot Key       Function                                      =
  50.     = ------------------------------------------------------------------------ =
  51.     =  Pencil      (ctrl)        place terrain under cursor                    =
  52.     =                                                                          =
  53.     =  Dropper     (option)      pick up terrain under cursor                  =
  54.     =                                                                          =
  55.     =  Arrow       (command)     select cells                                  =
  56.     =                                                                          =
  57.     =  Grabber     (spacebar)    move map around (slightly quirky still)       =
  58.     ============================================================================
  59.   
  60.   The terrain palette currently shows all of the terrain tiles available for
  61.   placement.  The currently selected terrain element is shown at the top of the
  62.   palette.  At the top-right, is a popup menu (that does nothing for now, but which
  63.   will be used to selectively display classes of terrain). Beneath the menu is
  64.   a checkbox that, if selected, will toggle the terrain displays to show them in
  65.   their damaged condition (note, the damaged tiles are normally on the palette,
  66.   but they sure don't appear to be in any particular order, so easier to find this
  67.   way)
  68.  
  69.   Once you are satisfied with your map, go ahead and save it.  You will also need
  70.   to export the LOS (line-of-sight) file (select this command from the File menu).
  71.   
  72.   To use your map and create fully customized scenarios, take a look at the
  73.   info blurbs I have on my web site:
  74.        http://www-leland.stanford.edu/~hills/games.html.
  75.        
  76.   
  77. About the LOS:
  78. ==============
  79.  
  80.   I understand that the LOS file is used by the strategic AI for determing the
  81.   routes for maneuvering troops, as well as for initial placement of the troops.
  82.   
  83.   The LOS file indicates the visibility between macro-tiles (a macro tile is a
  84.   3x3 square of map tiles). I currently have an algorithm to do a rough calculation
  85.   for this file, although it is by no means set.  (This is the "gotcha" that has
  86.   prevented map editors to-date...  The guys at Atomic mentioned that it took them
  87.   40+ minutes to compute, and then they adjusted by hand afterwards.)
  88.  
  89.   The Current Algorithm:
  90.     - locate the center of the source and target macro tiles
  91.     - determine the intermediate map tiles between those two
  92.     - for each intermediate map tile:
  93.           - determine the sight obstruction for the terrain type
  94.               (stored in the "CCCart Tile Info" file)
  95.           - add this obstruction to the total_obstruction
  96.           - if the total_obstruction > threshold, then LOS blocked.
  97.   
  98.   Other Ideas:
  99.     - Atomic's LOS format allows for differentiating the LOS for prone infantry
  100.       vs. vehicles/standing infantry.
  101.     - use a "4 corners" approach, rather than centers
  102.       (ie--check LOS between the corners of the source and target, relieving
  103.        some of the granularity introduced by approximating everything at the
  104.        centers)
  105.   
  106.   
  107.  
  108. Peculiarities:
  109. ==============
  110.  
  111.     * trees appear "bald" (the same as if you had "hide trees" selected in the
  112.       game options).  I believe that the tree tops are handled separately as
  113.       sprites, which I haven't even tried to fiddle with... anyone feel strongly
  114.       about including them?
  115.     * yes, if you disable GWorlds, most of the things that draw the map are slower
  116.       and more flickery.  On the positive side, you can have more and larger maps
  117.       and the "Zoom In" and "Zoom Out" commands are faster.
  118.     * you may need to increase the memory allocation for Close Combat if you start
  119.       using large maps.
  120.   
  121. Troubleshooting:
  122. ================
  123.   
  124.   If there is a problem with CCcart, you should first try to reboot
  125.   and try it again.  If that doesn't work, delete the "CC Cartographer"
  126.   file in the "System/Preferences" directory.
  127.   
  128.   Please let me know of any crashes:  hills@sensors.stanford.edu
  129.   (I actually do try to keep some of my programs bug-free)
  130.   When sending bug reports, please include the following:
  131.     - computer model (e.g., "PowerMac 7600")
  132.     - system version
  133.     - version of CC Cartographer (check the About... box)
  134.     - memory allocated to CC Cartographer
  135.     - description of what you were doing when it crashed
  136.       (e.g., "I had been opening and closing a bunch of maps when the
  137.        program locked up...")
  138.   
  139. Future Revisions:
  140. =================
  141.   
  142.   ==>  LET ME KNOW OF ANY DESIRED FEATURES/BUG-FIXES!
  143.        (and especially user interface suggestions)
  144.   
  145.   Current priorities:    
  146.      - squelch any bugs that turn up
  147.      - implement the terrain selector
  148.        (this looks to be a pain in the neck--I can't see any organization
  149.        in the order of terrain tiles)
  150.      - 4-corners LOS
  151.      - complete other basic tools (fill/clear)
  152.          
  153. Acknowledgements:
  154. =================
  155.  
  156.   John Anderson (wargamer@atomic.com)
  157.         - a tremendous amount of help (best cooperation I've ever had from
  158.           the actual developers of a game).
  159.   Mark Clouden (icode@dfm.com)
  160.         - figured out the bulk of the @#! LOS file format, and even shared it
  161.           with me -- thanks!  He is a bit tough to get a hold of, as he has
  162.           a penchant for changing ISPs every couple of months...
  163.   
  164. Who I Am:
  165. =========
  166.  
  167.   An EE graduate student, majoring in racquetball (I wish)... but mostly I'm
  168.   found in the cleanroom or some-such.  (My research is on micromachined 
  169.   electrodes for measuring nerve activity within the brain cortex.  I am
  170.   currently looking for a few good volunteers ;-)
  171.  
  172.  
  173. ---------------------------------------------------------------------------
  174.   *    Appendix :  Development Notes
  175. ---------------------------------------------------------------------------
  176.  (these are notes for myself--so they may not make much sense to you :-)
  177.  
  178.  
  179. CCC Development Notes
  180.  
  181. Long-Term:
  182.         - fill, clear
  183.         - multiple undo/redo (two stacks)
  184.         - segregation of terrain types
  185.         - strategic view
  186.         - PICT in clipboard (?) -- need to offset
  187.         - set max image size... conform window (Scroll to (0,0))
  188.         - general bullet-proofing
  189.         - long-term palettes (damaged terrain, classification, etc...)
  190.         
  191. Idea:    
  192.         - data file for terrain types.
  193.         - build terrain classes on fly (read from source file):
  194.                 
  195. Still to do:
  196.     - background terrains for cut/clear/new map
  197.     - 4-corners LOS option
  198.        (trace LOS from each of 4 corners)
  199.                     
  200. Current troubleshoots:
  201.         - why is progress dialog not passing events through?
  202.         - need to set mUserBounds in order to force resize properly...
  203.           (in particular, need to set the zoom bounds)
  204.           --> do this with subclass?
  205.         - still having problems with clipboard
  206.         
  207. 1/5/97  - LOS fully implemented now
  208.         - new About dialog box        
  209. 1/4/97  - CCCTileInfo up and running
  210.         - checkbox to show damaged tiles in Terrain Palette
  211.         - improved handling of exceptions
  212.         - fixed potential bugs if Tile/TileInfo files not specified
  213.         - CProgressBar implemented for LOSGenerator dialog
  214.         - first cut at CCCStackLOSGenerator
  215. 1/3/97  - fixed bug with radio boxes in preferences dialog
  216.         - enabled half-size for terrain palette
  217.         - graphics on clipboard
  218.         - now allow running w/o using GWorld
  219.         - fixed paste clipping bug
  220.         - Select All implemented
  221.         - check for filetype and creator when opening
  222.           (so user does not double-click "Tile Info" file and get an empty map window)
  223. 1/2/97  - added zoom in/out on map
  224.         - switch to watch cursor while GWorld being redrawn
  225.         - Preferences... dialog
  226. 12/15   - added tile # to the terrain palette
  227.         - added provision for low-memory drawing (no offscreen GWorld for map)
  228. 12/12    - fixed problem activating window palettes (thanks David Reiss!)
  229.           (colors initially incorrect if open application with a document
  230.            and have the terrain window closed)
  231.         - current terrain 
  232. 11/21    - force window resize for MapView if small map
  233.         - fixed drag-selection bug (losing focus)
  234.         - current terrain displayed in terrain palette
  235. 11/20    - removed slip in grabber
  236.         - updated Query Size dialog box
  237. 11/18    - paste undo/redo now update properly
  238.         - clean up app CLUT/palette
  239. 11/17   - synchronized color palettes between windows
  240.         - buffering MapView offscreen
  241. 11/16    Following functionality:
  242.             - copy/paste
  243.             - pencil, selector, dropper, grabber
  244.             - map view
  245.             - read Terrain Tiles
  246.             - read Map
  247.             - CCTiles alias in preferences
  248.             - mapfile saves
  249.